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Annex Communications Server R6.0 Installation Notes 


Introduction 

These installation notes are for R6.0 of the Annex Communications Server operational software. An Annex 
downloads the operating code from a host running Annex file server software. The Annex software can 
interface with any UNIX host that supports the TCP/IP protocols. 

Installing the Annex software requires access to the host selected as an Annex file server. At that host, you 
can load and compile the Annex file server software, edit certain configuration files, and start the erpcd 
daemon. 

This document contains the following sections: 

• Preparation 

• Host installation 

• Annex installation 

• Host-specific installation instructions 

• list of files 

Use these installation instructions either to install new Annexes or to update the operational code with a new 
release of software. If you are installing a new Annex, read all sections. For updating software, you need to 
read only the Host Installation section, and Boot Procedures for Upgrading Software (in the Annex Installation 
section). 

The Annex Communications Server Network Administrator’s Guide provides instructions for installing optional 
software. 


Note: These instructions cover software installation for all models of the Annex, including the 
original Annec, the Annex n, the Annex He, the Annex-802.5, and the Annex 3 . The 
term Annex refers to all models unless otherwise noted. 


Preparation 

If you are installing a new Annex, perform the following steps: 

1. Select the directory that will serve as the root of the Aimex source tree. This directory requires 
approximately 2.5 megalytes of memory to read the tape, and approximately twice this amount to 
build the programs. 

2. Select the directory that will contain the compiled Armex support programs. The Armex installation 
procedures uses the /usr/annex directory if it exists; otherwise, it uses the /etc directory. (See below 
to select another directory.) This directory requires approximately .5 megabytes of memory. 
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3. Allocate space in /nsr/spool for the Annex (^rational code. The boot image requires between 1 
and 2 megal^es in /usr/spool/erpcd/bfs, which is created the installation script. Furthermore, 
dumps can require from 1 to 3 megat^es for each Annex serviced by this file server. 

Host Installation 

This section includes the following information on the installation of the Annex software at the host: 

• Contents of the distribution media 

• Step-l^-step installation procedures 

• Host set-up procedures 


Distribution Contents 

The distribution media contains the Annex operational code and host-resident Annex support utilities. 
These utilities are distributed in C language source form with appropriate make files. Aimex operational 
code is compiled. 

Host-resident Annex support utilities are: 

aprint 

di_p8sswd 
erpcd 

ienll6d 
mk_rotaries 
na 

rtelnet 
timserver 


The Annex printer utility (intended for sites that cannot modify the 
Berkeley spooler). 

The Annex user password change utilify. 

The expedited remote procedure call daemon, which listens for Annex requests 
on a reserved UDP port (121). The daemon contains two programs: bfs, the block 
file server used the Aimex to access host-resident files; and acp, the Access 
Control Protocol (ACP) program that responds to host-based security requests. 

The IEN-116 name server. 

The port rotaries file /usr/spool/erpcd/bfs/rotaries4» definition utility. 

The Annex Network Administrator utility 

A pseudo-tty device create utility, which allows such UNIX programs as tip and 
auq> to access serial devices attached to Annex ports. 

The time server that updates the Annex’s time-of-day clock. 
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The distribution tape provides diffs to the standard 4.2/4.3BSD sources for the Berkelq^ LPD spooling 
^tem. Applied to standard sources, these diffs create a version of the ^x)oling ^tem that understands 
remote Annmc printers. The distribution tape also contains diJJs to sources of the 4.2BSD network daemons, 
riogind and teinetd. These diffs contain bug Hxes to these daemons. Refer to the Annex Communications 
Server Network Administrator’s Gtude for instructions on applying these diffs. 


installation Procedure 

After you have mounted the distribution media on the file server host, perform the following steps: 

1. Create a directory to serve as the root of the Annex software tree if it does not already exist. For 
example: 

# i&dir /usr/Atinex 


2. Change to this directory. For example: 

# fid /ttBr/«nnex 


3. Extract the contents from the source distribution using the following conunand: 


# is***:: 




If you are installing the operational code onto a PC rurming the XENIX operating ^tem, use the 
above command to extract the file, tar-image, from the diskettes. Next, using the following 
command, change the tar-formatted file, tar-image, to the desired Armex directory structure: 

# tar -xvf tar-image 

You may want to save the list of files to verify that all files in the source distribution have been 
detracted. For example: 

0 tar -XV > annex, films # for tape media 


or 


0 for floi^y dlakettea 


A list of distributed files is provided at the end of this document. 

4. Run the install-annex scrq>t to generate a configuration of your system, and to install the Annex host 
utilities and man pages. Any prompt that has a default di^lays it in brackets ([ ]). Pressing Return 
enters the default. 
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The configuration sequence of the installation scr4>t generates two files: src/Makefile and 
src/makexonfig. These files compile and install the Annex tools, lb run the script, enter the 
following command: 

# ^ /install -annax 

The following dialogue is a typical installation script. What you see can vaiy, depending on the type 
of qrstem on which you are installing the Annex software. 

Annex R6.0 Host Utilities Installation Script 

This installation shell script will exaaine your systea and possibly ask you 
questions to generate the needed configuration to allow you to conpile the Annex 
host utilities. 

This script does not need to be run as root. In fact, its best that you not run it 
as such. Only the installation process need to be run as root. You can abort the 
script at any tine and restart it without any ill effects. Once install-annex 

completes the configuration section, you will only need to use 

"make all" and "aake install" 

from the src directory to later rebuild or re-install the utilities. 

At any question prompt you can escape to a shell by typing "!". When you exit that 

shell you will bounce back to the question prompt. Many of the questions will have 

default answers in square brackets; tjrping carriage return will give you the 
default. 


Type carriage return to continue. Your cursor should be here- 


J RET I 


At this point, press the Return to continue the installation script. 

Beginning configuration. 

Locating common programs... 

ar is in /bin/ar. 

awk is in /bin/awk. 

cat is in /bin/cat. 

cc is in /bin/cc. 

chown is in /etc/chown. 

chmod is in /bin/chmod. 

cp is in /bin/cp. 

date is in /bin/date. 

echo is in /bin/echo. 

expr is in /bin/expr. 

grep is in /bin/grep. 

nkdir is in /bin/mkdir. 

mv is in /bin/mv. 

ranlib is in /usr/bin/ranlib. 

rm is in /bin/rm. 

sed is in /bin/sed. 

Don't worry if any of the following aren't found... 
inetd is in /etc/inetd. 

I don't see pack out there, offhand, 
strip is in /bin/strip. 
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Next^ the script prompts for the machine type and operating system of the host: 

Select the aost appropriate aachine type 


1. Encore Multiaax 

2. Sun 

3. UNISYS 

4. Tahoe (CCI Powers/S2 et al) 

5. Convergent 

6. NCR 

7. Pyraaid 

8. Concurrent 

9. PC/AT 

10. Sequent PTX 

0. Generic (no special code needed) 
Enter Machine Type #: 2 


Select the aost appropriate OS 

1. 4.[23]BSD Unix (& UMAX BSD) 

2. SYS_V Unix (& UMAX V) 

3. XENIX System V 

4. MACH 

Enter OS #; 1 


After you respond to both questions, the script verifies that the desired functions are installed on 
your qrstem. If a function is not found, either not found, adding ox not found, substituting displays next 
to the missing function. 

Checking your system for these functions — 

#include <systypes.H> ok 

#include <netinet/in.h> ok 

bcopyO ok 

bzeroO ok 

dup2 0 ok 

gethostbynameO ok 

gethostnameO ok 

htonlO ok 

htonsO ok 

ntohlO ok 

nthos () ok 

inet_addr() ok 

inet_ntoa() ok 

recvfromO ok 

recvmsgO ok 

sendmsgO ok 

sendtoO ok 

index ok 
rindex ok 
select ok 
u_char ok 
u^short ok 
u_long ok 
hostent ok 
servent ok 
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If your operating ^stem is a UNIX System V, the script asks what type of networking software you 
have before it displays the install and build messages. It may ask additional questions, depending on 
your machine type and networking software. For assistance with installing the Annex software on 
some specific System V hosts, refer to the section Host-specific Installation Instructions. 

Next, the scrq)t asks you where to install the Annex utilities and the Annex man pages. 


Where do you want the annex utilities installed? 


[/usr/annex] 


What kind of on-line aanual page layout do you have? 
Select the nost appropriate on-line aamual page layout: 


1. V7/BSD (/usr/man/man?) 

2. SystemV (/usr/{catBan,aan}/[apu]_Ban/aan?) 

3. None (donH install on-line aanual pages autonatically) 


Enter on-line aanual page type # 



You have several location options for installation of man pages, based on the type of tystem you 
have; you also have the option of not installing man pages. 

If you select number 1, to install the man pages using a BSD page layout, you are queried for the 
directories in which these manual pages reside: 

How should the on-line nanual pages be installed? 

1. One directory (i.e., all in /usr/man/man1) 

2. Multiple directories (i.e., under /usr/man in manl,man5,man8) 


Enter on-line manual page layout type: [l] 

If you select number 2 to install the man pages in multiple directories, the following query displays: 

what base directory should be used? [/usr/man] 

If you select to install the man pages in one directory, you are asked the following questions: 

How are manual page extensions handled in /usr/man/manl? 

1. They use a fixed extension like ".1" 

2. They use the extension of the manual page 

(i.e., ".1", ".5", ".8" - note that this is not typical) 

I pFT I 

Enter Manual page extension type: [1] I-1 

What is the extension used? [1] 1 J 
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However you elect to install the man pages, the following display indicates that the configuration 
portion of the script is complete: 

Configuration coaplete. 

The next step in the script is to compile and install the annex tools: 


shall I coapile the tools for you? 


[y] 


RET 


If you answer y, the following is displayed: 

Output being saved in "Build.out" 
Building libannex **♦ 


♦** Building tiaserver ♦♦♦ 


Followed by the next question: 


shall I install the tools for you? 


[y] 


I RET I 


If you answer y, the following is displayed: 

Output being saved in "Install.out" 
*** Installing Annex iaages 


Installing tiaserver »*♦ 

Done. 

If you did not compile and install the tools, the following is displayed: 

Installation not coapleted. 

To compile the tools use "cd src ; aake" 

To install the tools and aanual pages use "cd src ; aake install" 
Done. 


At this point the installation procedure is complete. 

If you need to rebuild or reinstall the Annex software in the future, you need to run only make and make 
instaU from the src directory. 
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Host Server Set-up Procedures 

A new Annex reqtiires the following edits to host files on the file server before downloading software: 

1. Add the following line to /etc/servioes to define a UDP port for the erpcd daemon: 

expo 121/udp # rpc listener 

Note: Perform this step only if you have an /etc/services file on your system. 

2. Verify that the following line, required the Annex aprint utility, is in the /etc/services file: 

printer 515/tcp spooler # line printer spooler 

3. If you are installing software on a host running Sun Microsystem’s Yellow Pages, you must 
re-initialize the yellow pages database before any changes to /etc/services take effect. 

4. Log in as root and run erpcd, which is located in the directory where you installed the Annex utilities. 
As a daemon, erpcd detaches itself and retumsyour terminal to the UNIX shell. You can verify that 
erpcd is running with the command: 

# -jitat I grep erped 

5. Update /etc/rcJocal to start erpcd when the system is booted. 

6. The security server (acp) is disabled with the distribution. If you wish to enable the security server, 
you must edit the /etc/eservices file and remove the pound sign (#) in front of the line defining acp. 
(Refer to the Annex Communications Server Network Adrrmustrator’s Guide for more information.) 

Additional host set-up procedures may involve a name server and a time server. Refer to the Armex 
Communications Server Network Administrator's Guide for discussions on these set-up procedures. 


Annex Installation 

After the Annex software is loaded on the file server host, install the operational code by booting the Annex. 


Boot Procedures for Upgrading Software 

If you are upgrading Annex software, you can boot your Annex after installing the (^rational software on a 
file server host. Enter the boot command from either the superuser CLI or na. After the Annex boots, it will 
be up and running the latest version of the operational software. 
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Boot Procedures for New Annexes 

This section provides a brief summary of the steps required for powering up the Annex and downloading the 
operational code to it. 

After you have installed the Aimex software on the file server host: 

1. Collect information for the Aimex boot parameters. The Aimex needs these parameters to perform 
an initial boot to load the software. Enter these parameters into the Annex’s EEPROM using ROM 
monitor commands, which are accessed throu^ the Aimex Console. 

2. Select the type of connection between the file server host and the Annex. The options are: 

• The Annex and host are on the same network and the same subnet. 

• The Annex and the host are on two different networks that communicate through a 
gateway. 

• The Annex and the host are connected by serial ports using the Serial Line Internet 
Protocol (SUP). 

The following manuals contain information on connecting a terminal for use as the Annex Console and 
details on the ROM Monitor commands: 

• Annex II Communications Server Hardware Guide 

• Annex lie Comirmnications Server Hardware InstaUatim Guide 

• Artnex-802.5 Conmunications Server Hardware Guide 

• Annex 3 Comrrmnications Server Hardware Guide 


The boot procedures for a new Annex are: 

1. Set the Annex’s Internet address and other initial boot parameters with the ROM monitor. Refer to 
Chapter 3, ROM Mtmitor Commands, in the apprcqiiiate hardware guide. 

2. For all Annex models excq^t the Annex 3, set the NORMAL/DIAG switch on the rear panel of the 
Annex to the DIAG position. 

For the Annex 3, which automatically powers up in NORMAL mode, press the Test switch on the 
front panel witiun 30 seconds of power up to enter TEST mode. 


May 1991 


9 




Armex Commumcations Server R6.0 Installation Notes 


3. At the Annex Console (the terminal attached to Port 1), enter the boot command: 

Monitor:boot 

If you do not enter a file name with the command, you are prompted for one (a default file name is 
displayed at the prompt). Press the Return kqr to enter the default file name. 

The terminal displays messages describing the boot request, followed messages describing the 
downloading. 


During a normal power-up and boot sequence, the Aimex front panel indicators light. Refer to thePoH>er-up 
and Test section in Chapter 2 of the appropriate hardware guide for a discussion of the sequence. (If the 
indicators do not light as documented, refer to Chapter 4, Troubleshooting Procedures, in that guide.) 

The download takes between 30 and 60 seconds for an Annex booting over the local network. If you are 
booting over a SUP interface, the speed of the serial line affects the amount of time needed for the 
download. The length of time can be anywhere from S minutes for a 19200 baud line, to 80 minutes for a 1200 
baud line. 


4. For all Annex models except the Annex 3: 

When you see EOF display on the terminal, set the NORMAUDIAG switch to the NORMAL 
position. Now you are at the Annex CU (the normal user command level). The Annex is up and 
running. 


S. For the Aimex 3: 

Do not press the Test switch when you see EOF display on the terminal. 

Note: The CU does not appear on the console terminal. You can access it only from a terminal 
connected to one of the Annex 3’s serial ports. Refer to Chapter 2 of Annex 3 
Communications Server Hardware Guide for instructions on connecting serial devices. 


After the Annex has loaded the operational code, the Command line Interpreter (CU) banner and prompt 
appear as: 


Annex Comnand Line Interpreter * Copyright 1991 Xylogics, Inc. 
annex: 
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Host-specific Instaiiation Instructions 

This section provides installation instructions for the following manufacturers: 

• ARIX825 

• ARIX/CMC 

• BuU 

• HP 9000 (HP-UX) 

• MIPS 1000 and Silicon Graphics 

• Motorola 

• SCO TCP/IP 

The following instructions have been tested on the hardware platforms and operating system software listed 
under each manufacturer. 

You also need to check whether your host has an alternate include directory for the network code and, if so, 
where it is located. You will need to locate the direaoiy in which the include files reside. 


ARIX825 

The following set of instructions was tested using the ARDC 825 hardware platform and the Arete 8000S 3.32 
Vers 3.3.3 ARIX V3.1 operating system software running Excelan network software. These instructions are 
not guaranteed to work with all ARIX 825 systems, but should provide guidelines for other ARIX 825 
machines and software releases. 

lb install the Annex distribution software on the above ^em, perform the following steps: 

Step 1. Run the install-anDex scr^t. Answer the following questions as noted: 

Select the moat appropriate machine type 
Select: Generic (no special code needed) 

Select the most appropriate OS 
Select: system V Unix (& UMAX V) 

What kind of Network Software does your OS have? 

Select: 2 . Excelan EXOS package 

Does your system have any auxiliary libraries for the network code?[n] 
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Select: y 

Enter any additional loader options for the network libraries 
Enter -Isocket -Infs.c 

Does your systen have an alternate include directory for network code[n]? 
Select: y 

where are the network include files located? 

Enter /usr/include/EXOS 

Step 2. Do not compile the tools at the end of the installation script. That is, answer n to the 
following question: 

shall I compile the tools for you? 

Step 3. Copy: 

/usr/include/sys/time.h 

to: 

src/inc/sys/time.h 

Step 4. Copy: 

/usr/include/rpc/netdb.h 

to: 

src/inc/rpc/netdb.h 

Step 5. Then, edit the copy of the netdbJi file to comment out the definitions of seirent and 
hostent. 

Step 6* Compile and install the tools: 

cd src 
make 

make install 


ARIX/CMC 

The foUowing set of instructions is not guaranteed to work with all CMC systems, but should provide 
guidelines for other CMC machines and software releases. 
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lb install the Annex distribution software on the above system, perform the following steps: 

Step 1. Run the instalf-annex script. Answer the following questions as noted: 

Select the aost appropriate aachine type 
Select: Generic (no special code needed) 

Select the aost appropriate OS 
Select: Systea V Unix (k UMAX V) 

What kind of Network Software does your OS have? 

Select: CMC package 

Step 2. Do not compile the tools at the end of the installation script. That is, answer n to the 
following question: 

shall I compile the tools for you? 

Step 3. Add the following lines to the src/inc/configJi file: 

#define big_endian 
#define need_sendto 
#define sendto _sendto 

Also, remove the line have.msghdr if defined. 

Step4. Copy: 

src/include/sys/socket.h 

to: 

src/inc/sys/socket.h 

Next, edit the copy to remove (using #ifdef) the definition of the msghdr structure. 

Steps. Compile and installeipcd: 

cd src 
aake 

aake install 
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Step 6. Edit src/inc/configJi file again to remove the following lines: 

#define need^sendto 
#define sendto sendto 


Step?. Compile and install na: 

# cd src/na 

# sake -f ../aake.config -f Makefile install 


Bull 

The following set of instructions were testing using the Bull DPX-2 hardware platform and the BOS 68000 
operating ^em. These instructions are not guaranteed to work with all Bull ^ems, but these instructions 
should provide guidelines for other Bull machines and software releases. 

lb install the Annex distribution software on the above system, perform the following steps: 

Step 1. Run the install-annex script. Answer the following questions as noted: 

Select the aost appropriate aachine type 
Select: Generic (no special code needed) 

Select the aost appropriate OS 
Select: Systea V Unix (& UMAX V) 

What kind of Network Software does your OS have? 

Select: 4. [234]BSD or coapatible 

Does your systea have any auxiliary libraries for the network oode?[n] 

Select: y 

Enter any additional loader options for the network libraries 
Enter: -linet 

Does your systea have an alternate include directory for network code[n]? 
Select: n 

Step 2. Do not compile the tools at the end of the installation script. That is, answer n to the 
following question: 

shall I coapile the tools for you? 
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Step 3. Edit the src/inc/configJi to add the following lines: 

#define have^iovec 
#de£ine need^index 
#define need_rindex 

#include <port/libannex.h> 


Step 4. Change the following line in the src/makexonfig file from: 

CFLAG* 


to: 


CFLAG*-D SYSV 


Step 5. Compile and install the tools: 

cd src 

Bake 

Bake install 


HP 9000 (HP-UX) 

The following set of instructions were tested using the Hewlett Packard HP9000 hardware platform and the 
HP-UX Rev 3.0 operating qrstem software. These instructions are not guaranteed to work with all HP 
^ems, but they should provide guidelines for other HP machines and software releases. 

lb install the Annex distribution software on the above system, perform the following steps: 

Step 1. Run the instaU-aiinex scrq)t. Answer the following questions as noted: 

Select the aost appropriate aachine type 
Select: Generic (no special code needed) 

Select the aost appropriate OS 
Select: Systea V Unix (k UHAX V) 

What kind of Network Software does your OS have? 

Select: 4 . [ZSSJBSD or coapatible 

Step 2. Do not compile the tools at the end of the installation scr^t. That is, answer n to the 
following question: 

shall I coapile the tools for you? 
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Step 3. The header file /usr/indude/sys/socketJi defines the structure msghdr, which is not 
used by the HP-UX package. However, the compiler flags the structure as multiply 
defined, because the Annex software defines it. Tb overcome the compiler error, copy: 

/usr/include/sys/socket.h 
to: 

src/inc/sys/socket.h 

Then edit the copy to remove (using l^fdef) the definition of the msghdr structure. 


Step 4. Add the following lines to the src/inc/configJi file: 

#define need^recvasg 
#define recvnsg xy_recv®sg 
#define need^sendnsg 
#define aendmsg xy_sendasg 

Step 5£dit src/Iibannex/sendrecvx to change the names of all occurrences of the following 


routines: 




from: 

_sendmsg 

to: 

xy_sendmsg 

from: 

_8endto 

to: 

xy^sendto 

from: 

_recvmsg 

to: 

xy__recvmsg 

from: 

_recvfrom 

to: 

xy_recvfrom 


Step 6.There is a conflict between the names of the routines in the HP-UX TCP/IP library and 
some of those in the Aimex library (which are not used in the HP-UX version). It is 
therefore necessary to change the names of the Armex versions to resolve this conflict, 
lb do this, edit the src/libannex/sendrecvx file to change the foUowing line from: 

_recvfrom(s,asg, len. flags, from, fromlen) 

to: 

_XYrecvfroffl (s .msg. len. flags. from, fromlen) 


and change the line: 

_sendto(s.msg.len.flags.to.tolen) 


to: 

_XYsendto(s,msg.len.flags.to.tolen) 


Step 7. Edit src/makexonfig to change the following line from: 

LIBANX_C « erpc_8ubr.c srpc.c 
LIBANX_0 « erpc_8ubr.o srpc.o 

to: 

LIBANX_C « erpc_8ubr.c srpc.c sendrecv.c 
LIBANX_0 « erpc_8ubr.o srpc.o sendrecv.o 
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Step 8. Compile and install the tools: 

cd src 
■ake 

■ake install 


MIPS 1000 and Silicon Graphics 

The following set of instructions were tested using the MIPSIOOO hardware platform and the System V 
release 3_10C operating system software. These instructions are not guaranteed to work with all MIPS 
systems, but they should provide guidelines for other MIPS machines and software releases. 

lb install the Annex distribution software on the above ^stem, perform the following steps: 

Step 1. Run the install-annex scr^t. Answer the following questions as noted: 

Select the Bost appropriate aachine type 
Select: Generic (no special code needed) 

Select the aost appropriate OS 
Select: Systea V Unix (& UMAX V) 

What kind of Network Software does your OS have? 

Select: 4. [234]BSD or coapatible 

Does your systea have any auxiliary libraries for the network code?[n] 

Select: y 

Enter any additional loader options for the network libraries 
Enter -ibsd 

Does your systea have an alternate include directory for network code[n]? 
Select: y 

Where are the network include files located? 

Enter /usr/include/bsd 

Step 2. Complete the scr^t but do not compile the tools at the end of the installation script. 
Answer n to the following question: 

shall I coapile the tools for you? 
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Step 3. Change the following line in the src/makexonfig file from: 

CFLAGS> 


to: 


CFLACS—signed 


Note: There may already be other flags defined for CFLAGS. In this case, do not delete these 
flags; just add -tigned to CFLAGS. 


Step 4. Compile and install the tools: 

cd src 
make 

make install 


Motorola 

The following set of instructions were tested using the Motorola Delta Series hardware platform and the 
System V/68 and System V/88 operating system software. These instructions are not guaranteed to work with 
all Motorola ^sterns, but these instructions should provide guidelines for other Motorola machines and 
software releases. 

Step 1. Run the install-annex script. Answer the following questions as noted: 

Select the most appropriate machine type 
Select: Generic (no special code needed) 

Select the most appropriate OS 
Select: system V Unix {k UMAX V) 

what kind of Network Software does your OS have? 

Select: 4. [23]BSD unix (& umax bsd) 


Step 2. Do not compile the tools at the end of the installation script. That is, answer n to the 
following question: 

shall I compile the tools for you? 


Step 3. Edit src/inc/configJi to add the following lines: 

fdefine need^sendmsw 
#define sendmsg xy^sendmsg 
#define need_recvmsg 
#define recvmsg xy_recvmsg 
#define have_msghdr 
#define need^sendto 
#define sendto xy_sendto 
#define NEED 0 SENDTO 
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Step 4. Edit src/libannex/sendrecvx to change the names of all occurrences of the following 


routines: 




from: 

^sendmsg 

to: 

xy^sendmsg 

from: 

^sendto 

to: 

xy^sendto 

from: 

_recvmsg 

to: 

xy^recvmsg 

from: 

_recvfroa 

to: 

xy^recvfrom 


Step 5. Edit src/libannex/sendrecvx changing the following xy_sendtoO routine code segment 
from: 

#ifdef EXOS 

nwritten « 8end(8, to. re8idAsg, nreaain); 

#else 

/• XXX to who? •/ 
if (debug) 

fprintf(stderr. "NOT IIIPLEMENTEDlXn") ; 
nwritten « 8end(s, residmsg, nrenain, flags); 

#endif 


to: 


#ifdef EXOS 

nwritten « 8end(s, to. residmsg. nremain); 

#else 

#ifdef NEED_0_SENDT0 
#undef sendto 

nwritten « sendto(s.msg.len.flags.to.tolen); 
#define sendto _sendto 
#else 

/• XXX to who? ♦/ 
if (debug) 

fprintf(stderr. "NOT IIIPLEIIENTED!\n") ; 
nwritten s send(s. residmsg. nremain. flags); 

#endif 

#endif 


Step 6. Edit src/makexonfig to change the following line from: 

LIBANX_C » erpc_subr.c srpc.c 
LIBANX^O « erpc^subr.o srpc.o 

to: 


LIBANX_C « erpc_8ubr.c srpc.c sendrecv.c 
LIBANX_0 « erpc_8ubr.o srpc.o sendrecv.o 


Step?. Compile and install the tools: 

cd src 
make 

make install 
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SCO TCP/IP 

The following set of instructions were tested using a Compaq 386/20 portable and the Xenix System V 
Version 2.3.2 (for Intel 80386) operating ^rstem software. These instructions are not guaranteed to work with 
all TCP/IP packages, refer to the accompanying manuals for the package you are using for more information. 

Now, install the Annex distribution software by perform the following steps: 

Step 1. Run the instaU-anoex script. Answer the following questions as noted: 

Select the aost appropriate machine tjrpe 
Select: Generic (no special code needed) 

Select the aost appropriate OS 
Select: system V Unix (4 UMAX V) (Do not use XENIX System V) 

What kind of Network Software does your OS have? 

Select: 4. [234]BSD or coapatible 

Does your system have any auxiliary libraries for the network code?[n] 

Select: y 

Enter any additional loader options for the network libraries 
Enter, -lsocket 

Does your system have an alternate include directory for network code[n]? 
Select: n 

Step 2. Do not compile the tools at the end of the installation script. Answer n to the following 
question: 

shall I compile the tools for you? 

Step 3. The SCO TCP/IP package requires special compiler flags, lb use these flags, change 
the following line in the src/makexoiifig file from: 

CFLAG- -DINETD -DGENERIC -DSYS_V -I../inc 

to: 

CFLAG« -DINETD -DGENERIC -DSYS^V -DLAI^TGP -Di386 -pack -I../inc 
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Step 4. Normally, SCO Xenix does not supply a crypt routine. The Annex security. Access 

Control Protocol (ACPX requires the routine to encrypt passwords. You can create the 
following dummy routine: 

char *crypt(key,salt) 
char ♦key; 
char ♦salt; 

{ 

statue char buff[200]; 

strepy(buff,key); 
return buff; 

} 

Place this routine in the file src/libannex/cryptx. In the file src/makexonflg change the following 
lines from: 

LIBANX_C s erpc_subr.c srpc.c 
LIBANX_0 s erpc_subr.o srpc.o 


to: 


LIBANX_C » erpc_subr.c srpc.c crypt.c 
LIBANX_0 » erpcjBubr.o srpc.o crypt.o 


Step 5. When using the -pack option with the Xenix software, the Annex’s fprintf routine does 
not work. Tb fix this, create a routine called ^fprintf and have it call the original fprintf 
routine. The ^fprintf routine should be: 

#include <stdio.h> 

_fprint f(chan.f,ala.a2,aS,a4,a5,a6,a7,a8,a9. 

alO.all,al2,al3,al4.al5.al6,al7,al8.al9.a20) 
unsigned long chan; 

{ 

unsigned long newchan; 
newchan chan; 

if(chan ((unsigned int)stdout - 2)) newchem « stdout; 

if(chan ((unsigned int)stderr -4 )) newchan « stderr; 

return fprintf(newchan,f,ala,a2,a3,a4,aS,a6,a7,a8,a9,alO, 
all.al2.al3,al4,al5.al6,al7,al8.al9,a20); 

} 


Step 6. Place the above routine in the sre/Ubannex/fprintfx file. Change the foUowing lines in 
the sre/makexonfig file from: 

LIBAMX_C>erpc_8ubr.c srpc.c crypt.c 
LIBAMX_0>erpc_subr.o srpc.o crypt.o 


to: 


LIBANX_C°erpc_subr.c srpc.c crypt.c fprintf.c 
LIBANX_0>cerpc_subr.o srpc.o crypt.o fprintf 
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You must compile the src/libannex/fprintfx file without the ^Mck flag, by editing the 
src/libannex/Makefile file. After these lines: 

clean: 

${IUI} -f $(LIBANX_0) 

${R1I} -f libannex.a 

add the following lines: 

fprintf.o: fprintf.c 

${CC} -c fprintf.c 


Finally, you need to force the software to use the modified routine instead of the standard routine, 
adding the following line to the head of the src/inc/configeh file: 

#define fprintf _fprintf 

Step 7. Copy the file /usr/incIude/sys/socket.h to src/inc/sys/socket Ji. Edit this new file and 
clumge: 

/♦ 


* Message header 
*/ 

struct Bsghdr { 

for recvBsg and sendasg calls. 



caddr_t 

Bsg_name; 

/* optional address */ 

int 

Bsg_naaelen; 

/* size of address */ 

int 

Bsg_base; 

/* base address of data */ 

int 

asg_len; 

/* size of data */ 

caddr_t 

asg_accrights; 

/* access rights sent/received 

int 

asg_accrightslen; 



}; 


to: 


#ifdef 

NOTDEF 


/• 

* Message header 

for recvBSg and sendasg calls. 

struct BSghdr { 



caddr_t 

asg_naae; 

/* optional address */ 

int 

asg_naaelen; 

/« size of address */ 

int 

asg_base; 

/* base address of data */ 

int 

Bsg_len: 

/* size of data */ 

caddr_t 

asg_accrights; 

/* access rights sent/received 

int 

asg_accrightslen; 





#endif 


Step 8. Compile and install the tools: 

cd BTC 
Bake 

sake install 
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List of Files 

The following files are distributed with the release media: 


bfs/annex.l3 

920 blocks 

bfs/oper.16.8025 

1026 blocks 

bfs/oper.l6.enet 

1124 blocks 

bfs/oper.42.enet 

1110 blocks 

install-annex 

75 blocks 

man/cat/aprint.l 

11 blocks 

man/cat/erpcd.8 

13blod[s 

man/cat/eservices.S 

4 blocks 

man/cat/gateways.5 

19 blocks 

man/cat/mk_rotaries.8 

3 blocks 

man/cat/na.8 

3 blocks 

man/cat/rotaries.S 

14 blocks 

man/cat/rtelnet.8 

13 blocks 

nian/cat/timserver.8 

3 blocks 

man/src/aprint.l 

9 blocks 

man/src/erpcd.8 

10 blocks 

man/src/eservices.5 

4 blocks 

man/src/gateways.5 

13 blocks 

man/src/mk_rotaries.8 

2 blocks 

man/src/na.8 

3 blocks 

man/src/rotaries.S 

10 blocks 

man/src/rtelnet.8 

9 blocks 

man/src/timseiver.8 

3 blocks 

release 

1 blocks 

src/aprint/Makefile 

4 blocks 

src/aprint/apTint.c 

28 blocks 

src/aprint/aprint.h 

4 blocks 

src/aprint/parsecap.c 

15 blocks 

sic/di£fs/4.2/lpr/conunon.c.diff 

3 blocks 

src/di£fs/4.2/lpr/displayq.c.di£F 

3 blocks 

src/di£fs/4.2/lpr/lp.h.diff 

3 blocks 

src/diffs/4.2/lpr/printjob.c.diff 

9 blocks 

src/diffs/4.2/lpr/rmjob.c.diff 

3 blocks 

src/diffs/4.2/rlogind/rlogind.c.diff 

3 blocks 

src/diffs/4.2/telnetd/telnetd.c.diff 

8 blocks 

src/diffs/4.3/lpr/common.c.diff 

3 blocks 

src/diffs/4.3Apr/di^layq.c.di£f 

3 blocks 

src/diffs/4.3/lpr/lp.h.diff 

3 blocks 
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src/diffs/4.3/lpr/printjob.c.diff 

7 blocks 

src/diffs/4.3Apr/rni]ob.c.diff 

3 blocks 

src/erpcd/Makefile 

6 blocks 

src/erpcd/aq).c 

19 blocks 

src/erpcd/aq).h 

13 blocks 

src/eipcd/aq)_lib.c 

27 blocks 

src/erpcd/aq)_policy.c 

73 blocks 

src/erpcd/aq)_policy.h 

10 blocks 

src/eipcd/aq)_ipc.c 

19 blocks 

src/erpcd/annex-imtd 

3 blocks 

SFc/erpcd/bfs.c 

66 blocks 

src/eipcd/ch_passwd.c 

12 blocks 

src/erpcd/eipcd.c 

33 blocks 

src/erjxxl/eservices 

1 blocks 

src/eipcd/getaq>pw.c 

6 blocks 

src/erpcd/poliqr.doc 

44 blocks 

src/ien-116/Makefile 

3 blocks 

src/ien-116/ienl 16d.c 

11 blocks 

src/inc/config.h 

1 blocks 

src/mc/courier/courier.h 

9 blocks 

src/inc/erpc/bfs.h 

7 blocks 

src/inc/erpc/eipch 

Sblodcs 

src/inc/eipc/netadmp.li 

28 blocks 

src/mc/port/CMC.h 

4 blocks 

src/inc/port/EXOS.h 

S blocks 

src/inc/port/SUEh 

10 blocks 

src/inc/port/SYS_V.h 

3 blocks 

src/inc/port/libaimex.h 

8 blocks 

sic/inc/port/xtiio.h 

S blocks 

SFC/inc/sl4>/BSDsl^.h 

7 blocks 

STc/mc/sl4>/sl9_^eni.h 

8blodcs 

src/inc/slip/sl4>_user.h 

6 blocks 

src/inc/syslog.h 

7 blocks 

src/Iibannex/Makefile 

S blocks 

sic/libaimex/apijf.c 

S3 blocks 

src/libannex/api_if.h 

6 blocks 

src/Ubannex/bcopy.c 

1 blocks 

sic/Iibannex/oontents 

lblo(^ 

src/libannex/dup2.c 

3 blocks 

src/libannex/etpc_subr.c 

36 blocks 

src/libannex/hostiiame.c 

12blodcs 

sic/libannex/m_cksuin.c 

8 blocks 

src/libannex/inet.c 

14 blocks 
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src/libannex/4>_layer.c 

11 blocks 

srcyiibannex/sendrecv.c 

14 blocks 

src/libannex/servname.c 

6 blocks 

srcAibannex/sl4>_layer.c 

16 blocks 

src/libaimex/socket_layer.c 

30 blocks 

sic/Ubannex/srpcc 

33 blocks 

src/libannex/srpc.h 

S blocks 

src/ljbaimex/udp_layer.c 

12 blocks 

src/mk_rotahes/Makefile 

4 blocks 

src/mk_rotaries/example 

1 blocks 

src/mk_rotaries/nik_rotaries.c 

40 blocks 

src/ink_rotaries/rotary_rec.h 

8 blocks 

src/na/Makefile 

S blocks 

sic/na/cmd.c 

161 blocks 

src/na/conv.c 

74 blocks 

src/na/conv2.c 

28 blocks 

src/na/do.c 

70 blocks 

src/na/help.h 

69 blocks 

src/na/iftype.h 

4 blocks 

SFc/na/mainx 

16 blocks 

src/na/na.h 

34 blocks 

src/na/nanies.h 

4 blocks 

src/na/oem.h 

1 blocks 

src/na/parse.c 

113 blocks 

src/na/servenh 

3 blocks 

src/na/sub.c 

22 blocks 

src/na/vers-c 

1 blocks 

sic/netadm/Makefile 

10 blocks 

src/netadm/boot.c 

13 blocks 

src/netadm/broadcast.c 

8 blocks 

src/netadm/dumpbootx 

7 blocks 

src/netadm/get_anx_(q>tx 

5 blocks 

src/netadni/get_aiix_revx 

6 blocks 

src/netadm/get_da_paiamx 

7 blocks 

src/netadm/get_da_statx 

7 blocks 

src/netadm/get_ln_panunx 

8 blocks 

src/netadm/get_ln_statx 

8 blocks 

src/netadm/get_port_cntx 

6 blocks 

src/netadm/getjx)rt_eibx 

S blocks 

src/netadm/get_tr_cntx 

5 blocks 

src/netadin/iiut_socketx 

7 blocks 

src/netadiii/netadm.h 

6 blocks 

src/netadin/netadm_eiT.h 

7 blocks 

src/netadm/read_memoiyx 

9 blocks 
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src/netadm/reset_all.c 

6 blocks 

src/netadni/reset_annex.c 

6 blocks 

src/netadm/reset_line.c 

7 blocks 

src/netadni/retum_pa]:ani.c 

13 blocks 

src/netadin/rpc.c 

38 blocks 

src/netadm/set_da_param.c 

13 blocks 

src/netadin/set_inet_add.c 

7 blocks 

src/netadm/set_ln_param.c 

11 blocks 

src/netadm/verify_req).c 

7 blocks 

src/rtelnet/Makefile 

4 blocks 

src/rtelnet/rtelnet.c 

47 blocks 

src/rtelnet/rtelnet.smns 

60 blocks 

src/slq)d/Makefile 

4 blocks 

src/slipd/slipcfg 

1 blocks 

src/slq)d/slipd.c 

30 blocks 

src/slipd/stty.c 

11 blocks 

src/snmp/annex-mib.txt 

18 blocks 

src/snmp/mib.txt 

56 blocks 

src/timserver/Makefile 

4 blocks 

src/timserver/timserver.c 

11 blocks 
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